Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Tracks

DeleteTrackSegment

The DeleteTrackSegment function removes a specified segment from a track. You identify the segment to remove by specifying its starting time and duration.

pascal OSErr DeleteTrackSegment (Track theTrack, TimeValue in,
                                 TimeValue duration); 

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

in

Contains a time value specifying the starting point of the segment to be deleted. This time value must be expressed in the time scale of the movie that contains the source track.

duration

Contains a time value that specifies the duration of the segment to be deleted. This time value must be expressed in the time scale of the movie that contains the source track.

ERROR CODES

invalidTrack	-2009	This track is corrupted or invalid
invalidDuration	-2014	This duration value is invalid
invalidTime	-2015	This time value is invalid

SEE ALSO

To dispose of a track, call the DisposeMovieTrack function, described on page 2-137.